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PRIMARY OBJECTIVES: 

Develop a Graphical User Interface (GUI) that allows forecasters to manage the local HYSPLIT for 
both routine and emergency use. The interface allows forecasters to quickly determine the 
current HYSPLIT configuration for a list of predefined sites (e.g., fixed sites and floating sites), 
and to make any necessary adjustments to key parameters such as Input Model, Number of 
Forecast Hours, etc. This will help NWS MLB forecasters improve efficiency and reduce human 
error when running HYSPLIT in support of an incident involving toxic substances dispersed into 
the atmosphere. During emergencies, forecasters also have the ability to invoke playbook 
options (e.g., low-altitude rocket mishap, nuclear power plant mishap, etc.) to assist them in 
optimizing certain parameter settings such as Emission Duration, Emission Rate, Emission 
Elevation, etc. The interface is written in Tool Command Language (Td) / Toolkit (Tk) making it 
AWIPS compatible and able to run within most LINUX and Windows operating systems. 



GRAPHICAL USER INTERFACE POP-UP MENUS 




The HYSPLIT GUI has several menu buttons that when clicked additional menus pop-up. Three of them are 
displayed above. The Directories menu on the left allows the user to set or change file directories along with 
important background script names. The Restore Menu button (middle) allows the user to change the HYSPLIT 
parameters back to their default settings or those from a previous GUI startup. The menu on the right displays the 
playbook options that are available for the forecaster to select from. 


EXAMPLE HYSPLIT OUTPUT DISPERSION MAPS 


BACKGROUND 

• Responding to incidents involving the release of harmful airborne pollutants is a continual 
challenge for Weather Forecast Offices in the National Weather Service. HySPLIT guidance is 
generated for the purpose of obtaining useful trajectory and concentration forecasts 
associated with the significant release of harmful chemical gases, radiation, wildfire smoke, 
etc., into local the atmosphere. 

► In previous work (Dreher, 2009), the AMU obtained and installed the latest version of HYSPLIT 
on a Linux system that ingests routine NCEP model products. The AMU also configured a 
utility program to convert WRF EMS output Into HYSPLIT binary format for use in generating 
dispersion forecasts from a locally run mesoscale model. Several scripts were created to run a 
sequence of commands to generate HySPLIT trajectory and concentration output on a routine 
schedule. The scripts reference parameter files for each product that contain the necessary 
trajectory and concentration HYSPLIT variables. 

Previously, forecasters had to manually change text configuration files before running a 
HYSPLIT trajectory forecast. Example of the NAM Parameter text file that a forecaster would 
manually edit. 
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GRAPHICAL USER INTERFACE 

The HYSPLIT GUI allows the user to select site locations, model(s) of preference, map output selection, emission 
control data and an additional feature playbook option which automatically changes particle , vertical and horizontal 
parameters based on the source release. When a Submit button is pressed in the background the code process, apply 
functions to data or parameters and then outputs the proper formatted HYSPLIT configuration files. 

• Programmed using Tool Command Language (Tel) / Toolkit (Tk) programming language 

• Fixed Sites: The forecaster can enter or update information such as, Name, Latitude, Longitude, Forecast Time, 
Model choice, Emission Duration and Rate on the 10 daily updated sites. The HYSPLIT model runs daily for these 10 
sites. 

• Floating Sites: The forecaster can enter or update the same information as for Fixed Sites along with a playbook 
option on five additional daily sites. Once changed, these sites will be added to the 10 daily HYSPLIT model run. 

• Emergency Site: The forecaster can enter or update the same information as for Fixed Sites along with a playbook 
option on a single site and then have the HYSPLIT model run with those parameters once the submit button is 
clicked. 

• Playbook Option: The forecaster can select the category of the source release particulate. 
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HYSPLIT Concentration Plot - potential pollutant release 


CONCLUSIONS 

• The forecaster has control over all the input and selectable fields. 

• Up to 15 source sites can easily be configured. 

• Playbook option allows the forecaster to quickly select the particulate of the source release which then changes the 
parameter variables. 

• All titles, fields, buttons and labels have mouse over "Help’ describing their functionality. 

• Once done the forecaster just has to click on the “Submit" button, which will then update all configuration files. 

• An Emergency single site selection menu has been configured which allows the forecaster to quickly configure and 
run a HYSPLIT Trajectory forecast and view its graphics output. 
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